get_api_vars_set_requests

Список запросов на изменение значений переменных API

Параметры запроса

• (без параметров)

Возвращаемые значения

• Массив с данными запросов на изменение значений переменных типа Переменная API. Пример:

    [
        {
            "request_id": "186",
            "var": "P1_N1_var1",
            "value": 123
        },
        {
            "request_id": "187",
            "var": "P1_N1_var2",
            "value": 456
        },
        {
            "request_id": "188",
            "var": "P1_N1_var3",
            "value": 789
        }
    ]
  

  • var: имя изменяемой переменной
  • value: устанавливаемое значение
  • request_id: идентификатор запроса (используется при оправке результата обработки запроса функцией response_for_api_vars_set_requests)

Особенности

• Функция возвращает список set-запросов со стороны ядра SCADA-системы на изменение значений переменных API (запросы формируют операторы или другие сервисы системы).
• Пользовательский драйвер должен:
  • обработать данные запросы (изменить значения соответствующих переменных/регистров в узлах)
  • в случае успеха - уведомить об изменениях значений драйвер виртуальных переменных вызовом функций change_api_vars
  • вернуть результаты обработки каждого запроса (успех или ошибка) через вызов функции response_for_api_vars_set_requests
• Функция должна вызываться периодически для получения списка ожидающих set-запросов. Если запросы не будут обработаны за время, указанное в свойстве переменной API Таймаут записи, драйвер виртуальных переменных ответит ядру ошибкой DRV_VIRT_ERROR_TIMEOUT.
• Вместо постоянного вызова get_api_vars_set_requests возможна подписка функцией subscribe на событие api_vars_set_requests (пример подписки)

Пример

http://webscada.ru:11201/api/get_api_vars_set_requests